package com.xutianpeng.disk.role.service;

import com.xutianpeng.disk.menu.exception.MenuOccupyException;
import com.xutianpeng.disk.mybatis.entity.PtRoleEntity;
import com.xutianpeng.disk.mybatis.entity.PtUserEntity;
import com.xutianpeng.disk.mybatis.flexigrid.PagingEntity;
import com.xutianpeng.disk.mybatis.flexigrid.TblResponseEntity;
import com.xutianpeng.disk.mybatis.ztree.ZtreeEntity;
import com.xutianpeng.disk.role.entity.SearchRoleEntity;
import com.xutianpeng.disk.user.exeption.UserOccupyException;

import java.util.List;

public interface RoleService {
    /**
     * 分页查询角色列表
     * @param entity
     * @param paging
     * @return
     */
    TblResponseEntity<PtRoleEntity> queryRoleInfoListByPage(SearchRoleEntity entity, PagingEntity paging);

    /**
     * 查询角色信息
     * @param roleUuid
     * @return
     */
    PtRoleEntity queryRoleInfoById(String roleUuid);

    /**
     * 修改角色信息
     * @param entity
     */
    void modifyRoleInfoById(PtRoleEntity entity);

    /**
     * 增加角色信息
     * @param entity
     */
    void addRoleInfoById(PtRoleEntity entity);

    /**
     * 删除角色信息
     * @param ids
     */
    void deleteRoleByIds(String ids) throws UserOccupyException, MenuOccupyException;

    /**
     * 根据角色查询菜单ztree列表
     * @param roleUuid
     * @return
     */
    List<ZtreeEntity> queryMenuTreeListByRole(String roleUuid);

    /**
     * 保存角色和菜单对应关系
     * @param roleUuidArray
     * @param menuIdArray
     */
    void saveRoleRefMenu(String roleUuidArray, String menuIdArray);

    /**
     * 新增方法：根据角色ID查询关联的用户列表（带分页）
     * @param roleUuid 角色ID
     * @param paging 分页参数
     * @return 包含用户列表的分页响应实体
     */
    TblResponseEntity<PtUserEntity> queryUsersByRoleUuid(String roleUuid, PagingEntity paging);
}
